PATHMac OS 8 and 9 Developer Documentation > Human Interface Toolbox > Appearance Manager >

Programming With the Appearance Manager


ThemeWindowMetrics

Your application uses the ThemeWindowMetrics structure to inform the Appearance Manager of the dimensions of specific parts of your window. See the functions discussed in Drawing Theme-Compliant Windows for specific uses of the ThemeWindowMetrics type. The ThemeWindowMetrics structure is available with Appearance Manager 1.1 and later.

struct ThemeWindowMetrics {
    UInt16      metricSize;
    SInt16      titleHeight;
    SInt16      titleWidth;
    SInt16      popupTabOffset;
    SInt16      popupTabWidth;
    UInt16      popupTabPosition;
};
typedef struct ThemeWindowMetrics ThemeWindowMetrics;
typedef ThemeWindowMetrics *ThemeWindowMetricsPtr;

Field descriptions

metricSize
A value specifying the size of the ThemeWindowMetrics structure.
titleHeight
A measurement in pixels of the height of the title text in the current system font, including any icon that may be present in the title region. Set this field to 0 if the window does not contain a title.
titleWidth
A measurement in pixels of the width of the title text in the current system font, including any icon that may be present in the title region. Set this field to 0 if the window does not contain a title.
popupTabOffset
A measurement in pixels of the distance that the left edge of a pop-up window's tab is offset from the left edge of the window. This value is used in conjunction with the value passed in the popupTabPosition field to determine the actual position of the tab. Set this field to 0 if the window is not a pop-up window.
popupTabWidth
A measurement in pixels of the width of a pop-up window's tab. Set this field to 0 if the window is not a pop-up window.
popupTabPosition
A value specifying the rule to apply when positioning a pop-up window's tab. Set this field to 0 if the window is not a pop-up window. A value of kThemePopupTabNormalPosition specifies that the left edge of the tab is to be drawn at the position indicated by the popupTabOffset field. A value of kThemePopupTabCenterOnWindow specifies that the tab is to be drawn centered on the window; the popupTabOffset field is ignored. A value of kThemePopupTabCenterOnOffset specifies that the tab is to be drawn centered at the position indicated by the popupTabOffset field.

© 1999 Apple Computer, Inc. – (Last Updated 29 April 99)